home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / emulate / appleemu.arc / EMULATOR.DOC < prev   
Text File  |  1988-06-20  |  4KB  |  117 lines
  1.  
  2.  
  3.  Documentation for the Apple ][ A2.04 and Atari B1.01 versions of the
  4.  
  5.                     6502 EMULATOR ON THE ATARI ST
  6.                            Dec. 31, 1986
  7.  
  8.  
  9.                          by Darek Mihocka
  10.  
  11.      The emulators work on any ST with a minimum of 512K,  and  works
  12. in any resolution,  colour or monochrome. It can be used as a tool to 
  13. learn 6502 machine language,  but also, it allows the ST to run Apple 
  14. and Atari software.
  15.  
  16. Files in the APPLE.ARC file:
  17.  
  18.   - APPLE.TOS     (the emulator)
  19.   - EMULATOR.DOC  (this file)
  20.   - CONVERT.C     (source code for a Apple to ST file conversion)
  21.   - DEMO.BIN      (a demo program in Basic)
  22.   - DEMOZP.BIN    (zero page locations to make DEMO work)
  23.  
  24.      It is up to the user to create files called APPLSOFT.BIN and
  25. INTBASIC.BIN by transfering the two languages over to the ST. Both
  26. occupy memory locations $D000-$FFFF.
  27.  
  28. Files in the ATARI800.ARC file:
  29.  
  30.   - ATARI800.TOS  (the emulator)
  31.   - EMULATOR.DOC  (this file)
  32.  
  33.      It is up to the user to create file called OSB.BIN which is a
  34. binary file in DOS 2.0 format of the memory locations $A000-$FFFF.
  35.  
  36. DOS 2.0 format is $FF,$FF, start(lo), (hi), end (lo), (hi)
  37. followed by the actual binary data.
  38.  
  39.      The only software in the machine at load time is the monitor. 
  40. It  is  similar to the monitor found on Commodore PETs  and  Apple 
  41. ][s. All commands are one character long, followed by any required 
  42. parameters. The following is a command summary with examples:
  43.  
  44.        : - change contents of memory 
  45.                :12 34 56 puts 34 in 12 and 56 in 13
  46.  
  47.        B - boot virtual computer          
  48.           
  49.        D - display memory 
  50.                D 0000 0028 displays all memory from 00 to 28
  51.  
  52.        G - go to address
  53.                G 1234 starts executing at address 1234
  54.  
  55.        H - hardcopy control
  56.                H1 turns on printer output
  57.                H0 turns it off
  58.  
  59.        I - index of files on disk
  60.  
  61.        L - disassemble memory
  62.                L 3456 disassembles from 3456
  63.  
  64.        M - move memory block
  65.                M 4500 45FF 5600 moves 256 bytes from 4500 to 5600
  66.  
  67.        R - read binary file
  68.                R BASIC loads a file called BASIC into memory
  69.                format of file is $FF,$FF, start, end, data
  70.  
  71.        S - single step 
  72.  
  73.        T - trace
  74.  
  75.        V - view video output screen
  76.  
  77.        W - write binary file
  78.                W 1200 19FF TESTFILE
  79.  
  80.        X - exit
  81.  
  82. A  more  detailed command summary can be found in the  monitor  by 
  83. pressing the HELP key.
  84.  
  85.      Using  two modems,  you can download the operating  system  from 
  86. the Apple  to  the  ST.  If  you convert it  into  a  Atari  Dos  2.0 
  87. compatible file,  that is,  a 6 byte header containing $FF,$FF, start 
  88. address,  end address,  you can load it into the emulator with the  R 
  89. command.
  90.     
  91.      To transfer a program you load it into your Apple, and do a hex
  92. by modem to the ST. What you must transfer is a dump generated by the
  93. Apple monitor and it must be in the format that appears on the screen
  94. normally. You can modify the file CONVERT.C to change the format. Then
  95. compile CONVERT.C to CONVERT.TTP and type in the file name to convert
  96. and the new filename ending in .BIN.
  97.  
  98.      To  see  a real demonstration of the  emulator,  load  Applesoft 
  99. Basic by typing "R APPLSOFT" and hit RETURN,  then boot it by  typing 
  100. "B" and hit RETURN.  You will now be in an Apple ][ virtual computer. 
  101. Type "CALL 768".  Then load a program, e.g. "R DEMO" and "R DEMOZP".
  102. Then type "B" and hit return. The virtual computer should now have a
  103. demo program in memory.
  104. The  editing,  Basic,  the  machine language monitor,  and  even  the 
  105. graphics  are similar.  Most public domain software can similarly  be 
  106. copied over a null cable, and will execute on the emulator.
  107.  
  108.      To exit,  you must generate a software interrupt by executing 
  109. a  BRK  instruction.   For  example,   typing  "CALL  40000"  will 
  110. accomplish that.
  111.  
  112.      I know that these docs aren't too great but I'm uploading it long
  113. distance and don't want send over a novel!
  114.  
  115.  - Darek Mihocka     MegaBaud ST BBS 416-243-9519
  116.  
  117.